home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / MIDI0TO1.DOC < prev    next >
Text File  |  1996-10-05  |  4KB  |  126 lines
  1.         ******************************
  2.             MIDI0TO1 v1.1
  3.     
  4.            midi binary format 0 to 1
  5.               by Guenter Nagler 
  6.                 1995 
  7.           (gnagler@ihm.tu-graz.ac.at)
  8.         ******************************
  9.  
  10. [0] FEATURES
  11.     + reads a binary midi file of format 0 (needs to be valid)
  12.     + writes a binary midi files of format 1 
  13.     + splits all tracks of input into seperate track 
  14.     + creates a leading tempo track and a track for each used channel (1-16)
  15.  
  16. [1] BACKGROUND
  17. Midi format 0 contains only one track. Midi format 1 contains a tempo track 
  18. and one or more singlechannel tracks that should be played together. 
  19. Midi format 1 files are easier to modify (e.g. with MIDI2TXT/TXT2MIDI)
  20. because the channel jumping operator [##] is not needed. Midi format 1
  21. files are printed using MIDI2TXT as
  22.   MTrk($A)
  23.    ...
  24.   end Mtrk
  25.  
  26. Use MIDI2TXT -i to show the version of midi file.
  27.  
  28. [2] FILES DESCRIPTION
  29.  
  30. MIDI0TO1.EXE.........converter program
  31. MIDI0TO1.DOC.........this file, showing usage of MIDI0TO1.EXE
  32. MIDIIO.HPP...........header file for a c++ midi parser
  33. MIDIIO.CPP...........source code for a c++ midi parser
  34. MIDI0TO1.CPP.........c++ source code for midi 0 to 1
  35. MIDI0TO1.MAK.........make file for project 
  36. MIDI0TO1.CFG.........compiler options for make
  37. MIDI0TO1.PRJ.........compiler project for borland c++ compilers
  38. only MIDI0TO1.EXE is required to run program
  39.  
  40. [3] COPYRIGHT
  41.  
  42. MIDI0TO1 (c) 1995 was created by Guenter Nagler.
  43.  
  44. MIDI0TO1 is free and may be used as you wish with this one exception:
  45.  
  46.     You may NOT charge any fee or derive any profit for distribution
  47.     of MIDI0TO1.  Thus, you may NOT sell or bundle MIDI0TO1 with any 
  48.     product in a retail environment (shareware disk distribution, CD-ROM,
  49.     etc.) without permission of the author.
  50.  
  51. You may give MIDI0TO1 to your friends, upload it to a BBS, or ftp it to
  52. another internet site, as long as you don't charge anything for it.
  53.  
  54. [4] DISCLAIMER
  55.  
  56. MIDI0TO1 was designed to handle 100% compatible midi files.
  57. Normally the program stops when illegal or corrupt midifiles are 
  58. used at input. 
  59.  
  60. Use MIDI0TO1 at your own risk.  Anything you do with MIDI0TO1 is your
  61. responsibility, and not the author's.  Any damage caused to any person,
  62. computer, software, hardware, company, or business by running MIDI0TO1 
  63. is your responsibility, and the author will not be liable.
  64.  
  65. If you don't understand these terms, or are not sure of something, or
  66. are afraid something bad might come of using MIDI0TO1, don't  use  it!
  67. You are here forewarned.
  68.  
  69. [5] INSTALLATION
  70.  
  71. [MSDOS]
  72. Simply copy MIDI0TO1.EXE in a directory that is in your path.
  73. When you start the program without arguments
  74.  
  75. C:\> MIDI0TO1
  76.  
  77. you should get the usage text (see next section)
  78.  
  79. [UNIX]
  80. compile sources with your C++ compiler (e.g. GNU Compiler g++):
  81.  
  82. g++ -o midi0to1 midi0to1.cpp midiio.cpp
  83.  
  84. and run program
  85.  
  86. $ midi0to1
  87.  
  88. [6] USAGE
  89.  
  90. usage: MIDI0TO1 srcfile.mid destfile.mid
  91.  
  92. MIDI0TO1 does not convert files that are not of format 0!
  93. In this case the program prints the version and exits.
  94.  
  95. Warning: MIDI0TO1 does not warn about overwriting existing destfile.mid !
  96.  
  97. [8] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  98.  
  99.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  100.           contains all my dos/unix midi programs
  101.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  102.  
  103. [9] USE
  104. For example, you have a midi file example0.mid that you expect to be format 0.
  105.  
  106. MIDI0TO1 example0.mid example1.mid
  107.  
  108. If it is a format 2 midi, the program will stop with a message like that:
  109.    "example0.mid is format 2. This program does not convert it to 0."
  110.  
  111. If it is a format 1 midi, the program will stop with a message like that:
  112.    "example1.mid is already format 1"
  113.  
  114. If it is a format 0 midi, it will try to split the track into example1.mid:
  115.   23%  (counting from 0 to 100)
  116.   "output written to example1.mid"
  117.  
  118. [10] CHANGES
  119. v1.0 to v1.1:
  120.   * used updated midiio 
  121.   * when converting midi files containing many tracks (e.g. 130) a message
  122.     "assert failed ..." ocurred because of not enough memory 
  123.     changed assert into error message "out of memory" and compiled in large
  124.     memory model to access more memory.
  125.  
  126.